{{tag>serveur web}}

----


====== Cherokee : Serveur Web Rapide et Simple ======

{{ cherokee_indiankid.png }}

Cherokee est un serveur web tout comme [[:apache2]], plus simple et plus rapide.

Il se configure graphiquement ( pas besoin de modifier de fichiers .conf etc... ) et n'as pas besoin d'être redémarrer après des changements de configuration.

=== Ce que Cherokee ne peux pas faire ===

Malheureusement, il y a certaines choses que Cherokee ne sais pas faire... Celle qui ne sais pas faire, qui est le plus handicapant, c'est bien [[http://fr.wikipedia.org/wiki/WebDAV|WebDAV]].

Du coup, vous ne pourrez pas utiliser le mod_dav_svn pour avoir Subversion.

<note>En cours de création</note>



 ===== Pourquoi Cherokee ? =====

Cherokee est bien plus rapide qu'[[:apache2]], en témoigne ce graphique en provenance du site qui a fais des benchmark :

{{:cherokee_benchmark.jpg|}}

D'autant plus que toute sa configuration se fais par interface web:

{{:cherokee_admin_index.png|}}


 ===== Installation =====

 ==== Depuis les dépôts ====
<note important>Malheureusement, pour le moment, la version du dépôt est la 0.7.2. En ce moment, la dernière version est la 0.99.10.</note>

Cherokee se trouve dans les paquet du [[depots#universe_et_multiverse|dépôts Universe]] d'Ubuntu: **[[apt://cherokee|cherokee]] [[apt://php5-cgi|php5-cgi]]**

 ==== Depuis les sources ====

Vous devez télécharger la dernière version depuis le site: 

  wget http://www.cherokee-project.com/cherokee-latest-tarball

  tar xvzf cherokee-0.99.10.tar.gz
  cd cherokee-0.99.10
  ./configure
  make
  sudo make install
  sudo cp contrib/cherokee /etc/init.d/
  sudo chmod +x /etc/init.d/cherokee

Par contre, il vous faut absoluement le paquet php5-cgi pour que cherokee démarre: **[[apt://php5-cgi|php5-cgi]]**

 ===== Configuration =====

Maintenant que Cherokee est installé, il reste à le configurer simplement, par l'interface web.

 == Note si installé par paquets ==

Si vous avez choisi d'installer Cherokee par les paquets, par défaut, l'interface d'administration n'est pas accessible.
Il faut arrêter Cherokee, puis le relancer avec la commande cherokee-admin :
   sudo /etc/init.d/cherokee stop

Maintenant, vous pourrez continuer à lire le wiki


==== Accès à l'administration ====

Pour accèder à la zone d'administration de cherokee, et donc, configurer entièrement votre serveur web, il faut utiliser la commande cherokee-admin sur votre serveur.
Pour la version 0.99.10 retourne quelque chose comme ceci:
  $ sudo cherokee-admin
  
  Login:
    User:              admin
    One-time Password: ioQbuAOaE9pFPtXR
  
  Web Interface:
    URL:               http://localhost:9090/
  
  Cherokee Web Server 0.99.10 (Apr 15 2009): Listening on port ALL:9090, TLS
  disabled, IPv6 disabled, using epoll, 1024 fds system limit, max. 505
  connections, caching I/O, single thread

Il ne vous reste plus qu'a vous connecter à l'adresse indiqué ( Ici http://localhost:9090/ ) et entrer le login **admin** et le mot de passe généré.

Vous devriez arriver sur la page d'administration de Cherokee:

{{:cherokee_admin_page.jpg|}}

Une fois que vous aurez fini de configurer votre serveur, vous pourrez fermer le terminal ou vous avez lancé la commande admin de cherokee, ou faire un CTRL + C.
Ceci va mettre fin à la session d'administration.

Ici, vous pouvez directement démarrer le serveur et vous aurez à l'adresse http://localhost ceci:

{{:cherokee_start_page.jpg|}}


 ==== Mon premier site ====

Maintenant que votre serveur tourne, vous aller très certainement vouloir y faire tourner un site... :D

Par défaut, le répertoire de travail est **/usr/local/var/www**

Bon, tout le monde travail dans **/var/www**, donc si vous désirez changer cela, il va falloir changer la configuration par défaut.

Il suffit, dans la page d'administration, aller dans la section **Virtual Servers**, puis cliquer sur la configuration par défaut.

Là vous verrez une section **Paths** ( Chemins ), avec le paramètre **Document Root**, qui contient **/usr/local/var/www**.

Changez le, puis enregistrer.

 ===== Problèmes =====

 ==== libcherokee-base.so.0 No such file or directory ====

Si vous avez le message d'erreur suivant :
  cherokee-admin: error while loading shared libraries: libcherokee-base.so.0: cannot open shared object file: No such file or directory

Il suffit de lancer en tant que root ldconfig :
  sudo ldconfig

 ===== Références =====

  * Le site officiel [anglais]: http://www.cherokee-project.com/
  * Documentation [anglais]: http://www.cherokee-project.com/doc/

----

//Contributeurs : [[:utilisateurs:zedtux]].//